@asterxsk/kiln 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 asterxsk
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,170 @@
+# kiln — pi agent configuration
+
+> A forge-tuned, self-improving `~/.pi/agent` for [pi](https://github.com/badlogic/pi-mono): curated extensions, opinionated defaults, and an installer you can re-run without fear.
+
+<p align="center">
+  <a href="https://github.com/badlogic/pi-mono"><img src="https://badges.ws/badge/PI-0.84.4+-8b5cf6?style=for-the-badge&label_color=101418" alt="pi >=0.84.4" /></a>
+  <a href="https://nodejs.org"><img src="https://badges.ws/badge/NODE-22.19+-8b5cf6?style=for-the-badge&label_color=101418" alt="node >=22.19" /></a>
+  <a href="LICENSE"><img src="https://badges.ws/badge/LICENSE-MIT-8b5cf6?style=for-the-badge&label_color=101418" alt="license MIT" /></a>
+  <a href="#quick-start"><img src="https://badges.ws/badge/PLATFORM-MACOS_%7C_LINUX_%7C_WINDOWS-8b5cf6?style=for-the-badge&label_color=101418" alt="platform" /></a>
+</p>
+
+Dotfiles rot. Extensions drift out of sync. A fresh machine means an afternoon of copy-paste archaeology. **kiln** fixes that: your whole agent setup — workflows, TUI, keybindings, eleven curated extensions — lives in one versioned repo with an idempotent installer. Run it on day one, re-run it on day one hundred; your state survives either way.
+
+---
+
+## Quick start
+
+One line, then you're done:
+
+```bash
+# npm / bun (recommended — no Defender flag, no git needed)
+npx @asterxsk/kiln --yes
+# or: npm i -g @asterxsk/kiln && kiln --yes
+# or: bunx @asterxsk/kiln --yes
+```
+
+```bash
+# macOS / Linux / Git Bash (classic)
+curl -fsSL https://raw.githubusercontent.com/asterxsk/kiln/main/agent/install.sh | sh
+```
+
+```powershell
+# Windows PowerShell (5.1 or 7+)
+powershell -NoProfile -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/asterxsk/kiln/main/agent/install.ps1 -UseBasicParsing | iex"
+```
+
+What the installer does:
+
+1. Installs or updates `pi` itself (`@earendil-works/pi-coding-agent`)
+2. Installs the `pi-context-usage` and `@baretread/pi-forge` packages
+3. Clones `asterxsk/kiln` over plain HTTPS (no credential prompts, ever) and copies the managed files into `~/.pi/agent` — extensions and config get overwritten, your `settings.json`, `taste/`, sessions, and secrets are left alone
+4. Runs each extension's `install.sh` / `install.ps1` (`npm ci`)
+
+**Safe to re-run.** It back ups the extensions and config files it replaces, never touches per-user state, and accepts `--help` options (`--repo`, `--branch`, `--target`, `--local`, `--skip-pi`, `--skip-packages`, `--yes`) when you want control. The `npx` installer ships the config inside the tarball, so it needs no `git`; `--repo`/`--branch` fall back to a plain-HTTPS clone when you point at a fork.
+
+### Publishing the npm package
+
+```bash
+npm login                    # once, as asterxsk
+npm pack --dry-run           # review the file list — payload mirrors git, secrets must never appear
+npm publish --access public  # ships bin/kiln.js + agent payload
+```
+
+Prefer to do it by hand?
+
+```bash
+git clone https://github.com/asterxsk/kiln.git
+cp -r kiln/agent/extensions ~/.pi/agent/
+cp kiln/agent/{AGENTS.md,keybindings.json,settings.json} ~/.pi/agent/
+# then edit ~/.pi/agent/settings.json — models, providers, etc. (never commit auth.json)
+```
+
+---
+
+## Features
+
+- **Curated extensions** — 11 self-contained pi extensions, each with its own `package.json` and installer. No global dependency soup.
+- **Safe installer** — public HTTPS clone, atomic overwrites, narrow backups of only the files it replaces. Your config is never collateral damage.
+- **Forge-first UX** — `theme: forge`, fullscreen TUI, high thinking by default. Built for long sessions.
+- **Secret-free by construction** — `auth.json`, `sessions/`, `trust.json`, `models-store.json`, `bin/`, and `themes/.pi` are `.gitignore`'d. The repo holds config, never credentials.
+- **Cross-platform** — `install.sh` for macOS/Linux/Git Bash, `install.ps1` for PowerShell.
+
+### Extensions
+
+| Extension | What it does |
+|-----------|--------------|
+| `modelconf` | Per-provider model browser, fuzzy filter, bulk glob, `enabledModels` persistence |
+| `todo` | Agent todo list with overlay |
+| `ask-user` | Structured user prompts |
+| `background-terminals` | Long-lived terminal manager |
+| `subagents` | Subagent orchestration (Claude/Codex/pi) |
+| `file-search` | First-class `fd`/`rg` tools with binary auto-install |
+| `pi-web-access` | Web search & fetch |
+| `goal` | Goal-driven execution loop |
+| `trim-context` | Context compaction |
+| `status line` | Status line renderer |
+| `shared` | Cross-extension utilities (timeouts, sessions, context) |
+
+Each extension lives at `agent/extensions/{name}/index.ts` and installs independently.
+
+---
+
+## Repository layout
+
+```
+.
+├── README.md                    # ← you are here (GitHub-visible)
+├── .gitignore
+└── agent/
+    ├── AGENTS.md                # behavioral guidelines (merged into every session)
+    ├── README.md                # pointer → ../README.md
+    ├── settings.json            # canonical settings (the installer never overwrites yours)
+    ├── keybindings.json         # TUI keybindings
+    ├── install.sh               # macOS/Linux installer
+    ├── install.ps1              # Windows installer
+    └── extensions/              # self-contained pi extensions
+```
+
+Tracked paths only: `agent/extensions`, `agent/settings.json`, `agent/keybindings.json`, `agent/AGENTS.md`, `agent/install.*`, `README.md`. Everything else is local-only.
+
+---
+
+## Configuration
+
+`agent/settings.json` is the source of truth. The flavor in one glance:
+
+```json
+{
+  "theme": "forge",
+  "tuiMode": "fullscreen",
+  "defaultThinkingLevel": "high",
+  "packages": ["npm:pi-context-usage", "npm:@baretread/pi-forge"]
+}
+```
+
+Your live copy at `~/.pi/agent/settings.json` is yours — the installer patches the `packages` list in (so forge and context stay registered) and otherwise leaves it alone. See the full file for retry budgets, compaction, follow-up mode, and the rest.
+
+### Keybindings
+
+| Keys | Action |
+|------|--------|
+| `enter` | submit |
+| `shift+enter` | new line |
+| `ctrl+enter` | follow-up message |
+| `alt+s` | save models |
+
+See `agent/keybindings.json` for the full map.
+
+---
+
+## AGENTS.md
+
+The house rules, merged into every session: *think before coding*, *simplicity first*, *surgical changes*, *goal-driven execution*. Copied to `~/.pi/agent/AGENTS.md` on install — read it before sending the agent off to build things.
+
+---
+
+## Requirements
+
+- `pi >= 0.84.4` (`npm i -g @earendil-works/pi-coding-agent`)
+- `node >= 22.19.0` + `npm`, `git`
+- Platform: macOS, Linux, Windows (Git Bash or PowerShell)
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/asterxsk/kiln.git
+cd kiln
+./agent/install.sh --target /tmp/pi-test --skip-pi --skip-packages --yes
+ls /tmp/pi-test/extensions
+```
+
+The `--target` flag installs into a scratch directory, so you can test installer changes without touching your live config.
+
+---
+
+## License
+
+MIT

package/agent/AGENTS.md

@@ -0,0 +1,67 @@
+# AGENTS.md
+
+Behavioral guidelines to reduce common LLM coding mistakes. Merge with project-specific instructions as needed.
+
+## 1. Think Before Coding
+
+**Don't assume. Don't hide confusion. Surface tradeoffs.**
+
+Before implementing:
+- State your assumptions explicitly. If uncertain, ask.
+- If multiple interpretations exist, present them - don't pick silently.
+- If a simpler approach exists, say so. Push back when warranted.
+- If something is unclear, stop. Name what's confusing. Ask.
+- If unsure or need info, websearch first. If that doesn't resolve it, ask the user to clarify.
+
+## 2. Simplicity First
+
+**Minimum code that solves the problem. Nothing speculative.**
+
+- No features beyond what was asked.
+- No abstractions for single-use code.
+- No "flexibility" or "configurability" that wasn't requested.
+- No error handling for impossible scenarios.
+- If you write 200 lines and it could be 50, rewrite it.
+
+Ask yourself: "Would a senior engineer say this is overcomplicated?" If yes, simplify.
+
+## 3. Surgical Changes
+
+**Touch only what you must. Clean up only your own mess.**
+
+When editing existing code:
+- Don't pollute ~/ (userprofile) directory. Make temp files in the project directory.
+- Don't "improve" adjacent code, comments, or formatting.
+- Don't refactor things that aren't broken.
+- Match existing style, even if you'd do it differently.
+- If you notice unrelated dead code, mention it - don't delete it.
+
+When your changes create orphans:
+- Remove imports/variables/functions that YOUR changes made unused.
+- Don't remove pre-existing dead code unless asked.
+
+The test: Every changed line should trace directly to the user's request.
+
+## 4. Goal-Driven Execution
+
+**Define success criteria. Loop until verified.**
+
+Transform tasks into verifiable goals:
+- "Add validation" → "Write tests for invalid inputs, then make them pass"
+- "Fix the bug" → "Write a test that reproduces it, then make it pass"
+- "Refactor X" → "Ensure tests pass before and after"
+
+For multi-step tasks, state a brief plan:
+```
+1. [Step] → verify: [check]
+2. [Step] → verify: [check]
+3. [Step] → verify: [check]
+```
+
+Strong success criteria let you loop independently. Weak criteria ("make it work") require constant clarification.
+
+When testing code, write dedicated tests dont run one-off tests in bash.
+
+---
+
+**These guidelines are working if:** fewer unnecessary changes in diffs, fewer rewrites due to overcomplication, and clarifying questions come before implementation rather than after mistakes.

package/agent/README.md

@@ -0,0 +1,5 @@
+# Moved — see [`/README.md`](../README.md)
+
+This file was promoted to the repository root for GitHub visibility.
+
+See the canonical README at [`../README.md`](../README.md) — or browse it on GitHub: https://github.com/asterxsk/kiln#readme

package/agent/extensions/AGENTS.md

@@ -0,0 +1,68 @@
+# extensions
+
+## Purpose
+Each subfolder is a self-contained pi extension. Pi auto-loads any `extensions/<name>/index.ts` (or `extensions/<name>/package.json` with a `pi.extensions` field).
+
+## Ownership
+- Modular extension system for Pi.
+- Registration, integration, and architecture patterns across all extensions.
+
+## Local Contracts
+- **Independence**: Each extension folder is self-contained — no extension imports from a sibling.
+- **Bridges**: Cross-extension integration uses `globalThis` bridges (e.g., `globalThis.__pi_copilot_usage`, `globalThis.__pi_goal_state`). Bridge keys are prefixed with `__pi_` and unique per extension.
+- **NPM dep safety**: Every extension with npm dependencies must guard all top-level requires/imports in a try/catch. Missing deps log a warning, register with `status: "degraded"` or `status: "disabled"`, and return early rather than crashing Pi.
+- **Graceful degradation**: When an extension's peer is missing, it degrades gracefully. Widgets and commands from other extensions continue working.
+- **Self-contained rendering**: Extensions include their own components (e.g., `CompactToolBox`) rather than importing from a shared extension to avoid tight coupling.
+- **UI Primitives**: Extensions use `ctx.ui` methods (`setHeader`, `setFooter`, `setWidget`, `notify`, `custom`, `select`, `input`) independently.
+
+## Work Guidance
+- **Adding an extension**: 
+  1. Create a new folder `extensions/<name>/`
+  2. Add an `index.ts` with a default export that receives `pi: ExtensionAPI`
+  3. Add an `AGENTS.md` explaining purpose, API surface, and how to remove
+  4. Update the Child DOX Index in this file
+  - If npm deps are needed, add `"pi": { "extensions": ["./index.ts"] }` to `package.json` and run `npm install`.
+  - **All npm imports must be guarded**: wrap `require()` or dynamic `import()` in a try/catch at the top of `index.ts` (or call a lazy init function). If the dep is missing, log a warning, register with `status: "disabled"` (if non-optional) or `status: "degraded"` (if partial functionality), and return early. See `filechanges`, `artifacts`, and `pi-hermes-memory` for reference patterns.
+- **Feature Registration Pattern**: To make the LLM aware of a new extension, add a registration call at the top of its `default export`:
+  ```ts
+  export default function (pi: ExtensionAPI) {
+    (globalThis as any).__pi_extension_features?.push({
+      name: "my-extension",
+      description: "What it does — shown in system prompt",
+      commands: ["/cmd1"],
+      tools: ["tool1"],
+      shortcuts: ["Ctrl+X"],
+    });
+  }
+  ```
+- **Removing an extension**: Delete the folder. Tools/commands/shortcuts will disappear automatically, and peers will degrade gracefully.
+
+## Verification
+- Extensions should load automatically via `index.ts` or `package.json`.
+- Missing peer extensions should not crash the host extension (verify graceful degradation).
+- New extensions should appear in the system prompt under `## Loaded Extensions` if properly registered.
+
+## Child DOX Index
+- `agentzero/` — `/init` command (create or audit AGENTS.md) and global AGENTS.md injection into system prompt
+- `artifacts/` — `create_artifact`, `scaffold_artifact`, `render_artifact`, `list_artifacts`, `delete_artifact`, and `check_artifact` tools + `/artifacts` command: save/browse standalone html/md artifacts, opening html in the default browser (with WSL support) and md in a fullscreen reader (with line numbers, arrow cursor selection, inline commenting, and review submission)
+- `compactui/` — Compact tool rendering, responsive wrapping, assistant time tracking footer, tagged thinking dimming, tool status dot, and auto-hide notifications (3s).
+- `context/` — `/context` overlay: token grid breakdown with per-category color-coded visualization
+- `destructive/` — confirms before running deletion commands (`rm`, `del`, `git rm`, `git clean -f`, …): Allow/Deny prompt, blocks by default with no UI
+- `ferment/` — Structured delivery framework (scope, phases, steps) for long-running agent tasks
+- `9router-provider/` — Local/remote 9router AI gateway provider with auto-discovered models and `/login` integration
+- `filechanges/` — `/filechanges` overlay + accept/decline; tracks file modifications per session and exposes counts for the ui-customization footer
+- `goal/` — `/goal` command — autonomous task orchestrator with pause/resume, turn tracking, history
+- `header/` — Banner header: ASCII art on the left, provider/model/version info panel on the right
+- `instruct/` — Custom system instructions: shell preference, task tracking, no emojis, plan mode guidelines
+- `perms/` — Permissions manager and checklist (`/extensions`), plus plan mode (`/plan`, `plan` tool with strict disabling of `write`/`edit`/`bash` tools)
+- `pi-hermes-memory/` — Persistent memory system with MEMORY.md, SQLite, session search, skill storage, auto-consolidation
+- `powershell/` — `powershell` tool (LLM-callable) with compactui-style rendering
+- `questions/` — `questions` tool (multi-choice TUI with optional custom-answer fallback and ASCII sketches)
+- `spinner/` — Animated star spinner with theme-aware accent color, glow effect, and fun phrases
+- `ui-customization/` — Gradient ASCII header banner + status footer showing provider, model, token I/O, context usage, git branch, worktree, file changes; Alt+C compact shortcut; theme removal
+- `subagents/` — the `subagent`/`subagent_resume`/`subagent_interrupt` tools + `/sub` and `/jobs` commands: spawn isolated pi processes with predefined agent .md files. Runs in the BACKGROUND — returns a job id immediately and pings the agent with a follow-up message when the job finishes. Agents can be `interactive` (pause between phases, resumable) and use `session: fork|lineage` to inherit or trace parent context
+- `tasks/` — `/manage_task` command — background terminal task runner with output capture, wait, cancel; persists across sessions
+- `timers/` — `/schedule` command — one-shot and repeating timers with notifications, auto-delete on fire, and overlay browser
+- `todo/` — `todo` tool + `/todos` command — structured task list with status tracking, categories, reminders, and persistent overlay widget
+- `video-extract/` — `video_extract` tool: YouTube + local video content extraction via Gemini API, ffmpeg, and yt-dlp
+